home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1588.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  2.7 KB  |  115 lines
  1. 156
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. TempFileName 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baTempFileName returns a temporary file name that is guaranteed not to exist.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baTempFileName( Prefix )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. String. 
  36. --- RECORDSEPARATOR ---
  37. Prefix is a string of up to 3 characters that is used to generate the filename.
  38. --- RECORDSEPARATOR ---
  39.  
  40. --- RECORDSEPARATOR ---
  41. Returns:
  42. --- RECORDSEPARATOR ---
  43.  
  44. --- RECORDSEPARATOR ---
  45. String. 
  46. --- RECORDSEPARATOR ---
  47. Returns the file name, including the path.
  48. --- RECORDSEPARATOR ---
  49.  
  50. --- RECORDSEPARATOR ---
  51. Examples:
  52. --- RECORDSEPARATOR ---
  53.  
  54. --- RECORDSEPARATOR ---
  55. Director: 
  56. --- RECORDSEPARATOR ---
  57. set FileName = TempFileName( "gaz" ) 
  58. --- RECORDSEPARATOR ---
  59. Authorware: 
  60. --- RECORDSEPARATOR ---
  61. FileName := TempFileName( "gaz" )
  62. --- RECORDSEPARATOR ---
  63.  
  64. --- RECORDSEPARATOR ---
  65. Notes:
  66. --- RECORDSEPARATOR ---
  67.  
  68. --- RECORDSEPARATOR ---
  69. The file name will consist of the path name, a tilde "~" followed by the prefix, then a 
  70. --- RECORDSEPARATOR ---
  71. four digit number, with a ".tmp" extension; eg "c:\temp\~gaz1257.tmp". The file will 
  72. --- RECORDSEPARATOR ---
  73. not be created. 
  74. --- RECORDSEPARATOR ---
  75. Under 32 bit, the file name will consist of the path name, followed by the prefix, 
  76. --- RECORDSEPARATOR ---
  77. then a number, with a ".tmp" extension; eg "c:\temp\gaz12453.tmp"  An empty file 
  78. --- RECORDSEPARATOR ---
  79. with that name will be created. 
  80. --- RECORDSEPARATOR ---
  81. The baTempFileName function gets the temporary file path as follows::
  82. --- RECORDSEPARATOR ---
  83.  
  84. --- RECORDSEPARATOR ---
  85. 16 bit:
  86. --- RECORDSEPARATOR ---
  87.  1. 
  88. --- RECORDSEPARATOR ---
  89. The path specified by the TEMP environment variable 
  90. --- RECORDSEPARATOR ---
  91. 2. 
  92. --- RECORDSEPARATOR ---
  93. Root directory of the first hard disk, if TEMP is not defined.
  94. --- RECORDSEPARATOR ---
  95.  
  96. --- RECORDSEPARATOR ---
  97. 32 bit:
  98. --- RECORDSEPARATOR ---
  99.  1. 
  100. --- RECORDSEPARATOR ---
  101. The path specified by the TMP environment variable. 
  102. --- RECORDSEPARATOR ---
  103. 2. 
  104. --- RECORDSEPARATOR ---
  105. The path specified by the TEMP environment variable, if TMP is not 
  106. --- RECORDSEPARATOR ---
  107. defined. 
  108. --- RECORDSEPARATOR ---
  109. 3. 
  110. --- RECORDSEPARATOR ---
  111. The current directory, if both TMP and TEMP are not defined. 
  112. --- RECORDSEPARATOR ---
  113. Files created using file names returned by this function are not automatically 
  114. --- RECORDSEPARATOR ---
  115. deleted when Windows shuts down.